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XEDIT Command 



XEDIT 


(fn(ft(fm]]l 

[ (options. . . [ ) 1 1 


Involve XEDIT for named file. 
Specify fn. ft here or in LOAD. 


options: 






[Widthnn] 


Amount of storage for 1 line. 
Default = LRECL 




[NOSCreen] 


Force typewriter mode. 




[ PROFi le macroname ] 


Specify profile filename. Default = 
PROFILE 




[NOPROFil] 


Dont execute default PROFILE. 


options valid only in update mode: 






(Update] 


Apply and modify UPDATE file. 




[NOUpdate] 


Dont apply update statements. 




[Seq8] 


8 digits in columns 73-80 




[NOSeqS] 


3 chars.. 5 digits. 




[Ctlfnl] 
[NOCtl] 


Use Cf\^S UPDATE with fnl 
CNTRL. or not. 




[Merge] 


Merge updates into new file. 




[Incrnn] 


Minimum increment when adding 
lines. 




[SIDcode string] 


Overlay string in 64-71 for all 
updates. 



Targets 



Format 


Description 


:n 


absolute line number 


[+|-]n 


relative displacement from current line 


.xxxx[xxxx] 




symbolic name assigned by SET 
POINT (up to 8 chars.) or .xxxx (up to 
4 chars.) 


[+|-][-']/string1[/| ( 


-i]/string2/].. . 


12 3 i\ 


5 






string expression: 






1 search direction 






2 "NOT- this string 






3 string 






4 "OR" for and/or locate 






5 specify up to 4 strings 






In addition, you can use SET options 






(ARBCHAR. CASE. SPAN, and 






VARBLANK) to specify a complex 






string expression. 



XEDIT Subcommands 

Subcommand Operands 

Add [nil] 



Change 



CURsor 



Add n lines after current line. 



charl char2 I target 




Change a single character to 
another (character or hex), from 
current line to target, n times in 
each line, starting with the pth 
occurrence. (G valid with 
numeric target.) 



BAckward 


[nnii 




Scroll back n or * screens. 


Bottom 






Go to last line of file. 


CANCEL 






QUIT all files. 


CAppend 


[text] 




Add text to end of current line. 


CDelete 


[column 


-targetll] 


Delete characters from column 
pointer to column-target. 


CFirst 






Move column pointer to 
beginning of line (or ZONE). 



/old 



r /new/ Ttarget rPM||ll 



Change old string to new. from 
current line to target, p times in 
each line, starting with the qth 
occurrence in each line. 



CInsert 


text 


Insert text before column 
pointer. 


CLAst 




Move column pointer to end of 
line (or ZONE). 


CLocate 


column-target 


Move column pointer to 
column-target. 


CMS 


[commandline] 


Execute CMS command, or 
enter CMS subset mode. 


CMSG 


[text] 


Display text on command line. 


COMMAND 


[commandline] 


Execute subcommand without 
macro or synonym check. 


COM Press 


[targetll] 


Replace blank (or filler) 
characters with tabs, from 
current line up to target. 


copy 


target 1 target2 


Copy line(s) from current up to 
targetl and insert after target2. 


count 


/string[/target|l] 


Display how many times string 
appears, from current line to 
target. 


COVerlay 


text 


Overlay current line with text, 
starting at column pointer. 
Blanks do not overlay data; 
underscore overlays with blank. 


CP 


[commandline] 


Execute CP command. 


CReplace 


text 


Replace characters, one for 
one, starting at column pointer 
in current line. 



CMdIine [colnoHJ 

Column 

File lineno [coino] 

Screen lineno [coIno] 



Move cursor to: 
command line at col. number; 
current column, current line; 
lineno, colno. of file; 
lineno, colno, of screen. 



[targetll] 



Delete lines from current to 
target. 



[nnii 



Move line pointer n lines toward 
EOF. 



XEDIT Subcommands (continued) 

Subcommand Operands 



DUPIicat 


[nll[target|l]l 


Duplicate lin^s) n times, from 
current to target. 


EMSG 


[text|[mmmnnns text]] 


Display text and/or sound 
alarm, mmmnnns is VM/SP 
message id. 


EXPand 


[targetll] 


Expand line(s) from current to 
target, according to SET TABS. 


FILE 


[fn|=[ft|=[fml = l]] 


SAVE and QUIT. Default is 
current file(= = =). 


Find 


text 


Search for line that starts with 
text, ignoring blanks. 


FINDUp 
FUp 


text 


Search backward for line that 
starts with text, ignoring blanks. 


Forward 


[nnu 


Scroll forward n or • screens. 



Help 



HEXType 



Input 



MODify 



[fn| =[ft| =[fm| = I *] [firstreclUnumrecl *]]11 

Insert line(s) from specified file, 
starting with number of the first 
line, for the number of lines 
(numrec) specified. Use with no 
operands to GET lines saved by 
a PUT(D). 



[ menu "! 
HELP 
name J 



Display: 

list of XEDIT aibcommands; 

how to use HELP; 

XEDIT subcommand 

description. 



[targetll] 



Display in hex and EBCDIC, 
from current line to target. 



[line] 



Insert line or enter input mode. 



Column n 
CURSOR I 
colno I 
/string/ J 



Join lines: 

at column pointer; 

at cursor; 

at column number(s); 

with string(s) inserted. 



LEft 


[nil] 


View data n columns to left of 
column 1 . 


LOAD 


Same as XEDIT command. 


Issue XEDIT from profile. 


[Locate] 


target [subcommand] 


Move line pointer to target; then 
execute subcommand. 


LOWercas 


[targetll] 


Translate uppercase to 
lowercase, from current line to 
target. 


MACRO 


[macroline] 


Execute macro without synonym 
or subcommand check. 



keyword 



Display SET subcommand in 
command line to permit 
immediate change, keyword = 
SET option. 



MOve 


targetl target2 


Move line(s) from current up to 
targetl and Insert after target2. 


MSG 


[text] 


Display text or blank line in 
message line. 


Next 


[nj-lll 


Move line pointer n lines toward 
EOF. 


NFind 


text 


Search for line that does not 
start with text, ignoring blanks. 


NFINDUp 
NFUp 


text 


Search backward for line that 
does not start with text, ignoring 
blanks. 


Overlay 


text 


Overlay current line with text, 
starting at first tab column. . 
Blanks do not overlay data; 
underscore overlays with blank. 



I XEDIT Subcommands (continued) 

Subcommand Operands 



PUT 



ds 


Function 




Scan stacked line of macro 




starting at started for: 


Alphaword 


alphabetic character string; 


Number 


numeric character string; 


String 


delimited string; 


Dblstring 


delimited double string; 


Target 


XEDIT target; 


Word 


alphanumeric string; 


Line 


unprocessed part of line. 



POWerinp 




Enter continuous typing input 
mode. 


PREServe 




Save settings of XEDIT 
variables until RESTORE. 


PURge 


macroname 


Remove macro from virtual 
storage. 



[targetll[fn|=[ft|=[fm| = ]]]l 



Copy line(s) from current to 
target into named file (create or 
append) or unnamed temporary 
file (for retrieval by GET). 
Temporary file persists across 
multiple files. 



[target|l[fn|=[ftl=[fm|=ll]] 



Move line(s) from current to 
target into named file (create or 
append) or unnamed temporary 
file (for retrieval by GET). 
Temporary file persists across 
multiple files. 



Query 








Display (QUERY) or transfer 


TRAnsfer 


option 
options: 






(TRANSFER) SET options and 
other variables. With QUERY, 
only one operand may be 




APL 


Point[*]C 


Q only) 


specified. With TRANSFER, 




ARBchar 


PREfix 




multiple operands may be 




AUtosave 


RANge 




specified in one subcommand. 




CASE 


RECFm 








CMDIine 


RESERved 








COLPtr 


RING 








COLumn 


SCALe 








CURLine 


SCReen 








CURSor 


Seq8 








EOF 


SERial 








ESCape 


SIDcode 








FILIer 


Size 








FMode 


SPAN 








FName 


STAY 








FType 


STReam 








HEX 


SYNonym 


[•](Qonly) 




IMage 




[name] 






IMPcmscp 


TABLine 








LASTmsg 


TABS 








LENgth 


TARGet 








Line 


TERMinal 








LINENd 


TEXT 








LRecl 


TOF 








LScreen 


TOFEOF 








MACRO 


TRunc 








MASK 


UPDate 








MSGMode 


VARblank 








NBFile 


Verify 








NONDisp 


VERShift 








NULIs 


Width 








NUMber 


WRap 








PACK 


Zone 








PF[nl 


= 






QUIT 


[n] 






End editing session; n = return 
code. 










Put data in console stack (LIFO) 










from terminal: 


READ 


Cmdline 


1 




command input area; 




All [NUMBER] 




changed lines (with numbers); 




Nochange [NUMBER] 




like ALL but typed changes not 










permanent. 



XEDIT Subcommands (continued) 

Subcommand Operands 



RECover 


[nnu 




Retrieve n or * lines lost by 
DELETE. PUTD, or D. 


RENum 


[start-numberl 1 0[incrementTI 


Renumber FREEFORT or 
VSBASIC file. 


REPEat 


[targetll! 




Advance toward target and 
repeat last subcommand. 


Replace 


[text] 




Replace current line with text, 
or delete current line and enter 
input mode. 


RESet 






Remove prefix subcommands 
when screen is in pending or 
incomplete status. 


RESTore 






Restore settings from 
PRESERVE. 


Right 


[nil] 




View data n columns to the right 
of last on screen. 


SAVE 


[fn|=[ftl=[fm| 


= ]11 


Write file on disk; stay in XEDIT. 


SCHANGE 


[keynumber] 




Specify PF key to effect 
selective change. 


[SET] 


APL ON|OFF 




Allow use of APL keys. 


[SET] 


ARBchar ON | OFF [character] 


Turn on/off arbitrary character 
definition for use in targets, 
initial = OFF $ 


[SET] 


AUtosave nlOFF [mode|Al 


Issue SAVE every n lines 
changed, initial = OFF 



[SET] CASE Uppercase|Mixed [Respectllgnore] 

Translate lower to uppercase or 
not; respect/ignore case in 
target searches, 
initial = M R (SCRIPT, MEMO) 
initial = U R (other) 









Move command line to: 


[SET] 


CMDIine 


On 


last 2 lines of screen; 






Top 


same as message line; 






Bottom 


last line of screen, 
initial = ON 



[SET] 



[SET] 



[SET] 



[SET] 



[SET] 



[SET] 



COLPtr ON|OFF 



Display column pointer or not 
(typewriter only), initial = ON 



CURLine ON n 



Move current line to screen line 
n. initial: n = middle of screen 



ESCape ON|OFF [character] 



Allow use of/define character 
for subcommand entry in input 
mode (typewriter only), 
initial = ON, char based on ft 



[SET] 


FILIer [character] 


Define character used in 
EXPAND, initial = blank 


[SET] 


FMode fm 


Change fm of current file. 


[SET] 


FName fn 


Change fn of current file. 


[SET] 


FType ft 


Change ft of current file. 


[SET] 


HEX ON|OFF 


Allow string operands and 
targets to be specified in hex. 
initial = OFF 



IMage ON 
OFF 
Canon 



Control tabs and backspaces: 
expand tabs, backsp. is erase; 
tabs and backsp. left alone; 
backsp. rearranged, 
initial = CANON (SCRIPT) 
initial = ON (other) 



IMPcmscp ON|OFF 



Pass unrecognized commands 
to CMS/CP. or not. initial = ON 



LINENd ON|OFF [character] 



Allow use of or define line end 
character, initial = ON # 



XEDIT Subcommands (continued) 

Subcommand Operands 

[SET] LRecl n 



SET 



[SET] 



[SET] 



[SET] 



[SET] 



[SET] 



Define new logical record 
length, initial based on ft 



MACRO ON|OFF 



Search for macros before 
subcommands (ON), or vice 
versa (OFF), initial = OFF 



MASK Define 

lmmed[text] 
Modify 



Define overlay mask for new 

lines: 

type over scale; 

text = mask; 

display current mask. 

initial mask = blank 



[SET] 


MSGMode ON [Short|Long] 
OFF 


Control message display, 
initial = ON LONG 


[SET] 


NONDisp [character] 


Define character to display in 
place of nondisplayable ones, 
initial = blank 


[SET] 


NULIs ON|OFF 


Trailing blanks replaced with 
nulls, or not. initial = OFF 


[SET] 


NUMber ON|OFF 


Display line numbers, or not. 
initial = OFF 


[SET] 


PACK ON|OFF 


Write file to disk in packed 
format, or not. initial based on 
record format 



[string 1 

TABKEY I 
COPYKEY J 



Define /remove (no operand) 

meaning for a PF key: 

any subcommand or macro; 

PF key used as tab key; 

copy printer spool. 

initial: 

PF1 HELP MENU 

PF2 SOS LINEADD 

PF3 QUIT 

PF4 TABKEY 

PF5 SCHANGE 6 

PF6? 

PF7 BACKWARD 

PF8 FORWARD 

PF9 = 

PF10 SPLIT CURSOR 

PF1 1 JOIN CURSOR 

PF1 2 CURSOR COLUMN 



[SET] 


Point .symbol [OFF] 


Define /remove symbol for 
current line. 


[SET] 


PREfix ON [Left|Right]|OFF 
PREfix .Synonym new old 


Control prefix area display or 
define synonym for prefix 
subcommand, initial = ON LEFT 


[SET] 


RANge targetl target2 


Set limits for line pointer 
movement. 



RECFm F 
V 
FP 
VP 



Define record format: 

fixed; 

variable; 

fixed packed; 

variable packed. 

initial based on ft 



[SET] RESERved n High [text] 

Nohigh [text] 
OFF 



Reserve nth line of screen and 
display text, highlighted or not. 
OFF = release reserved line. 



SCALe ON [n] | OFF 



Display scale on n th line or 
remove, initial = ON, n is under 
current line 



SCReen n 

Size n1 [n2].. 



Define n logical screens. 
Define size of each screen, 
initial = SIZE n (n = physical 
screen size) 



XEDIT Subcommands (continued) 

Subcommand Operands 

[SET] SERial ON [incrno[startno]] 

ALL[incrno[startno]] 
string[incrno[startno]] 

OFF 



[SET! 



[SET] 



[SET] 



[SET] 



[SET] 



[SET] 



[SET] 



[SET] 



International Business Machines Corporation 

Data Processing Division 

1133 Westchester Avenue, White Plains, N.Y. 10604 



IBM World Trade Americas/Far East Corporation 
Town of Mount Pleasant, Route 9 
North Tarrytown, N.Y., U.S.A. 10591 

IBM World Trade Europe/Middle East/Africa Corporation 
360 Hamilton Avenue, White Plains, N.Y., U.S.A. 10601 



Function 

Put serial id at end of lines: 

3 chars.. 5 digits (10.10); 

8 digits (1000. 1000); 

string plus numbers to 8 places 

(10.10). 

No update of id at next SAVE. 



SPAN ON[Blanl<|Noblanl<[n| •]] Allow string target to span n 
OFF lines, with blank between lines 

or not. String target must be in 
one line (OFF), initial = OFF 
BLANK 2 



STAY ON|OFF 



Move line pointer when string 
not located, or not. initial = 
OFF 



STReam ON|OFF 



Search for column-target in 
entire file (ON) or current line 
only (OFF), initial = ON 



SYNonym ON|OFF 



Recognize synonyms, or not. 
initial = ON 



SYNonym newname[n]oldname 



Define synonym; n is minimum 
abbreviation. 



SYNonym newname[n[form1., 



formn]] oldname [&1 ...&n] 
Specify new name and operand 
formats (formi ...formn): 

& = blanks delimit; 

&/ = delimited string; 

&. = 2 strings separated by 1 

delimiter; 







& * = rest of data; 

&1 ...&n: relative order. 


[SET] 


TABLine ON [n] 
OFF 


Display line with -T" in each 
tab column, on n th line, or 
remove, initial = OFF 


[SET] 


TABSn1[n2...n281 


Define logical tab stops, initial 
based on ft 


[SET] 


TERMinal Typewriter 
Display 


Use display terminal in line 
mode or in full screen mode. 


[SET] 


TEXT ON|OFF 


Allow use of TEXT keys. 


[SET] 


TOFEOF ON|OFF 


Display null top and end of file 
(or RANGE) lines, or not. 
initial = ON 


[SET] 


TRuncnr 


Set truncation at n th column or 
• (LRECL). initial: n based on ft 



VARblank ONIOFF 



Number of blanks between 2 
words is insignificant in target 
searches (ON) or is significant 
(OFF), initial = OFF 



Verify [ONIOFF] [[H]c1 c2].. 



Display changed lines or not. 
Define which columns appear, 
in hex (H) or EBCDIC or both, 
initial = ON (typewriter) 
initial = OFF (display) 



WRap ONIOFF 



Wrap around file/ range during 
a search, or not. initial = OFF 



Zone zonel zone2|* 



Define left and right columns 

(zonel zone2) that delimit target 

searches. 

initial = column 1 to * 



Put string into equal buffer. 



LeftlRight [cols|lXtarget|l]] 



Move data to the left or right for 
number of columns (cols) 
specified, from current line to 
target. 



target [AjD] c1 c2 [c1 c2]... 



Sort from current line to target, 
in ascending (A) or descending 
(D) order. c1 c2 = sort fields. 



XEDIT Subcommands (continued) 

Subcommand Operands 

SOS option 

options: 



STAck 



STATUS 



Function 

Specify option for screen 
operation simulation. 





ALarm 


NUIIs OFF 






BField n 


PFn 






CLEAR 


POP 






Down n 


push 






Leftn 


Right n 






LINEAdd 


TABBn 






LINEDel 


TABCmd 






NField n 


TABCMDB 






NLine n 


TABCMDF 






NUIIs 


TABFn 






NUIIs On 


Upn 










Split line in two: 


SPlit 


Column 




at column pointer; 




CURSOR 




at cursor; 

Split line in two or more: 




coino 




at column number(s); 




[Be f oral Afterl/string/ 


before or after string(s). 



[target Tstartcol [length ||| 



Place line(s) FIFO in console 
stack, from current to target, 
starting in column specified 
(startcol) for number of columns 
specified (length). 



[filename] 



Display SET subcommand 
options and settings; or create 
macro with filename specified 
that contains these settings. 



TOP 






Move line pointer to TOF line. 


TRAnsfer 


See QUERY for operands. 


Place editing variable(s) in 
console stack for use by a 
macro. 


Type 


[targetlll 




Display line(s) from current to 
target. 


Up 


[nnii 




Move line pointer toward TOF. n 
or • (TOF) lines. 


UPPercas 


[target 11] 




Translate lowercase characters 
to uppercase, from current line 
to target. 


Xedit 


[fn[ft[fml]] [(options. 


■[)11 


Edit another file. See CMS 
command XEDIT for options. 



[subcommand] 



Use & before a subcommand for 
repeated execution. The 
subcommand remains in 
command line. 



[subcommand] 



Re-execute the last 
subcommand entered, or 
execute the subcommand 
specified here and then 
re-execute the last one. 



Display the last subcommand. 



Prefix Subcommands 

These subcommands are entered in the prefix area of a line. 



Prefix Subcommand 


Function 


A 
nA 

An 


Add one line. 
Add n lines. 
Add n lines. 


C 
nC 
Cn 
CO 


Copy one line. 
Copy n lines. 
Copy n lines. 
Copy block of lines. 


D 

nD 
Dn 
DD 


Delete one line. 
Delete n lines. 
Delete n lines. 
Delete block of lines. 


E 


Extend logical line by one more physical line on the 
screen. 


F 


Move or copy following this line. 


I 

nl 

In 


Insert one line. 
Insert n lines. 
Insert n lines. 


M 
nM 
Mn 
^4M 


Move one line. 
Move n lines. 
Move n lines. 
Move block of lines. 


P 


Move or copy preceding this line. 


SCALE 


Display the scale on this line. 


TABL 


Display a T" in every tab column on this line. 


/[n] 
[n]/ 


Make this line current and move the column pointer 
under the n th column. 


n"or "n 
•III 

""n or n"" 


Duplicate one line. 
Duplicate n lines. 
Duplicate block of lines. 
Duplicate block of lines n times. 


.xxxx 


Assign xxxx as symbolic name to this line. 



The following chart organizes XEDIT subcommands according to function. 



PUT(D) 

XEDIT (CMS command) 

XEDIT (subcommand) 


Create a file. 


CANCEL 

FILE 

QUIT 


End an editing session. 


SET AUTOSAVE 
SAVE 


Write file on disk; stay in edit. 


INPUT 

POWERINP 

REPLACE 


Enter an input mode. 


JOIN 
SPLIT 
SHIFT 
SORT 


Rearrange data on the screen. 


LEFT 

RIGHT 

SHIFT 

SET VERIFY 


Move the screen over the data or the data on 
the screen. 


SET CMDLINE 
SET CURLINE 
SET NUMBER 
SET PREFIX 
SET SCALE 
SCALE (prefix) 
SET SCREEN 
SET TABLINE 
TABL (prefix) 
SET TOFEOF 


Control the screen layout. 


SET FMODE 
SET FNAME 
SET FTYPE 
SET LRECL 
SET PACK 
SET RECFM 
SET SERIAL 
SET TRUNC 


Control file characteristics. 


GET 
PUT(D) 


Transfer data between files. 


CAPPEND 

CDELETE 

CFIRST 

CINSERT 

CLAST 

CLOCATE 

COVERLAY 

CREPLACE 


Used to move the column pointer or based on 
the position of the column pointer. 


BACKWARD 

BOTTOM 

DOWN 

FORWARD 

NEXT 

REPEAT 

TOP 

UP 

/ (prefix) 

all targets 


Scroll the screen and/or move the pointer. 


CLOCATE 

COUNT 

FIND 

FINDUP 

LOCATE 

NFIND 

NFINDUP 


Search for data. 


ALTER 

CHANGE 

COVERLAY 

CREPLACE 

OVERLAY 

SCHANGE 


Change data. 



CINSERT 

SET NULLS ON 

with insert key 
PA2 key 

with insert key 


Insert characters. 


A (prefix) 
ADD 

C (prefix) 
COPY 
D (prefix) 
DELETE 
" (prefix) 
DUPLICAT 
E (prefix 
F (prefix) 
1 (prefix) 
M (prefix) 
MOVE 
P (prefix) 


Related to line editing. 


SET POINT 
.xxxx (prefix) 


Name a line. 


CMS 

CP 

SET IMPCMSCP 


Transmit command to CMS or CP. 


COMMAND 
MACRO 
SET MACRO 
SET SYNONYM 


Control search order for macros, 
subcommands, and synonyms. 


LOWERCAS 
SET CASE 
UPPERCAS 


Related to the case of letters. 


ALTER 
HEXTYPE 
SET HEX 
SET VERIFY 


Related to hexadecimal data. 


COMPRESS 

EXPAND 

SET IMAGE 

SET PFn TABKEY 

SET TABLINE 

TABL (prefix) 

SET TABS 


Related to tabs. 


COLPTR 
ESCAPE 


Related to typewriter terminal. 


SET ARBCHAR 
SET CASE 
SET HEX 
SET IMAGE 
SET RANGE 
SET SPAN 
SET STAY 
SET STREAM 
SET TABS 
SET VARBLANK 
SET WRAP 
SET ZONE 


SET options related to the entry of or search 
for data. 


CMSG 

EMSG 

LOAD 

MSG 

PARSE 

PRESERVE 

PURGE 

READ 

RESTORE 

SET MSGMODE 

SET RESERVED 

SOS 

STACK 

STATUS 

TRANSFER 


Use in macro writing. 



Notes: 



